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METHOD AND APPARATUS FOR A CONFIGURABLE JAVA SERVER PAGES 

PROCESSING FRAMEWORK 

BACKGROUND OF THE INVENTION 

5 

1. Technical Field: 

The present invention relates generally to an 
improved data processing system and, in particular, to a 
method and system for processing JavaServer pages. Still 
10 more particularly, the present invention relates to a 
method, apparatus, and computer instructions for a 
configurable JavaServer pages processing framework to 
process JavaServer pages. 

15 2. Description of Related Art: 

With increasing use of the Internet, customer 
demands on information provided by Web pages have become 
more dynamic. Web developers are not only required to 
generate presentation of Web pages, but also business 

2 0 logic required to generate dynamic contents, such as, for 
example, a name and an email address of a user from a 
server. The demand for a flexible method to build 
dynamic Web pages contributes to the development of 
JavaServer pages, a technology available from Sun 

25 Microsystems, Inc. 

JavaServer pages (JSP) provide Web developers an 
open, freely available specification that provides the 
advantages, such as, platform- independence, use of the 
Java programming language, and compatibility with a 

30 variety of technologies, such as Web servers, Web 

browsers, and application servers. A JSP page is a Web 
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page with containing a markup language and additional 
Java code. Examples of markup languages are hypertext 
markup language (HTML) , extensible markup language (XML) 
and wireless markup language (WML) . The Java code is 
5 embedded within tags. When the JSP page is called, this 
page is compiled by the JSP engine into a Java servlet, 
which is handled by a servlet engine. The servlet engine 
loads the servlet class using a class loader and executes 
the class to create dynamic HTML to be sent to the 

10 browser. The next time the same JSP page is called, the 
JSP engine executes the already- loaded servlet. 

JSP allows Web developers to separate user interface 
from content generation through the use of tags. Tags 
may be in the form of extensible markup language (XML) , 

15 which encapsulates the logic that generates the content 
of the page. These tags allow reusable components to be 
encapsulated, to make building of Web pages easier. 

However, due to increasing complexity of the JSP 
source file and evolving JSP specification, the use of 

2 0 JSP technology described above has become more costly. 

The maintenance cost of JSP processors, such as a JSP 
engine inside an Application server or an integrated 
development environment (IDE) that authors and tests JSP 
pages, has also increased. In addition, all JSP pages 
25 are required to be validated syntactically for 

correctness before further processing can be done. With 
different JSP processors, different requirements are 
present. For example, an IDE tool may need to present a 
graphical view of JSP page for editing and a JSP engine 

3 0 may need to generate a Java source file from the JSP 

page. 
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Therefore, it would be advantageous to have an 
improved method, apparatus, and computer instructions for 
a configurable JSP processing framework that supports new 
and different requirements for JSP processing, has 
detailed knowledge of the JSP specification, performs 
syntax validation, and customarily executes JSP 
processing tasks. 
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SUMMARY OF THE INVENTION 

The present invention provides a method, apparatus, 
and computer instructions for a configurable JavaServer 
pages (JSP) processing framework to process JSP. In a 
5 preferred embodiment, the processing framework of present 
invention provides a JSP translator that translates a JSP 
document or page into a document object model (DOM) 
object. A JSP processor, such as a service or tool 
provider, may use the JSP translator to configure custom 

10 classes, known as "visitor" classes, to be invoked in a 
certain sequence, so that custom functions may be 
performed on the DOM object to return custom results. 
The configuration of custom classes is stored in XML 
format using a JSP visitor configuration file. The 

15 processing framework of present invention also includes 
built-in classes and a JSP engine that validates the 
syntax of the JSP and return any errors if necessary. 



i 
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BRIEF DESCRIPTION OF THE DRAWINGS 

The novel features believed characteristic of the 
invention are set forth in the appended claims. The 
5 invention itself, however, as well as a preferred mode of 
use, further objectives and advantages thereof, will best 
be understood by reference to the following detailed 
description of an illustrative embodiment when read in 
conjunction with the accompanying drawings, wherein: 
10 Figure 1 is a pictorial representation of a network 

of data processing systems in which the present invention 
may be implemented; 

Figure 2 is a block diagram of a data processing 
system that may be implemented as a server in accordance 
15 with a preferred embodiment of the present invention; 

Figure 3 is a block diagram illustrating a data 
processing system in which the present invention may be 
implemented; 

Figure 4 is a diagram illustrating processing 

2 0 framework of the present invention in a data processing 

system in accordance with a preferred embodiment of the 
present invention; 

Figure 5 is a diagram illustrating components of 
translating a JSP document or page into a DOM object 
25 using a DOM generator in accordance with a preferred 
embodiment of the present invention; 

Figure 6 is a diagram of an example schema used in 
the present invention for the JSP configuration file in 
accordance with a preferred embodiment of the present 

3 0 invention; 
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Figure 7 is a diagram illustrating an example JSP 
visitor configuration file used in the present invention 
in accordance with a preferred embodiment of the present 
invention; 

5 Figure 8 is a diagram illustrating components used 

in processing DOM object using a collection of visitor 
classes in accordance with a preferred embodiment of the 
present invent ion ; 

Figure 9 is a flowchart process of configurable JSP 
10 processing framework of the present invention in 

accordance with a preferred embodiment of the present 
invention; 

Figure 10A is a diagram illustrating example 
validation of JSP in accordance with a preferred 
15 embodiment of the present invention; 

Figure 10B is a diagram illustrating example 
validation of a tag file in accordance with a preferred 
embodiment of the present invention; and 

Figure 11 is a diagram illustrating component 
20 interactions for validating a JSP and generating Java 

source file from the JSP in accordance with a preferred 
embodiment of the present invention. 



7 EXPRESS MAIL NO, EV333421931US 

Docket NO.RSW920030178US1 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

With reference now to the figures, Figure 1 depicts a 
pictorial representation of a network of data processing 
systems in which the present invention may be implemented. 
5 Network data processing system 100 is a network of 
computers in which the present invention may be 
implemented. Network data processing system 100 contains 
a network 102, which is the medium used to provide 
communication links between various devices and computers 

10 connected together within network data processing system 
100. Network 102 may include connections, such as wire, 
wireless communication links, or fiber optic cables. 

In the depicted example, server 104 is connected to 
network 102 along with storage unit 106. In addition, 

15 clients 108, 110, and 112 are connected to network 102. 
These clients 108, 110, and 112 may be, for example, 
personal computers or network computers. In the depicted 
example, server 104 provides data, such as boot files, 
operating system images, and applications to clients 108- 

20 112. Clients 108, 110, and 112 are clients to server 104. 
Network data processing system 100 may include additional 
servers, clients, and other devices not shown. 

In the depicted example, network data processing 
system 100 is the Internet with network 102 representing a 

25 worldwide collection of networks and gateways that use the 
Transmission Control Protocol/Internet Protocol (TCP/IP) 
suite of protocols to communicate with one another. At 
the heart of the Internet is a backbone of high-speed data 
communication lines between major nodes or host computers, 

3 0 consisting of thousands of commercial, government, 

educational and other computer systems that route data and 
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messages. Of course, network data processing system 100 
also may be implemented as a number of different types of 
networks, such as for example, an intranet, a local area 
network (LAN) , or a wide area network (WAN) . Figure 1 is 
5 intended as an example, and not as an architectural 
limitation for the present invention. 

Referring to Figure 2, a block diagram of a data 
processing system that may be implemented as a server, 
such as server 104 in Figure 1, is depicted in accordance 

10 with a preferred embodiment of the present invention. 
Data processing system 200 may be a symmetric 
multiprocessor (SMP) system including a plurality of 
processors 202 and 204 connected to system bus 206. 
Alternatively, a single processor system may be employed. 

15 Also connected to system bus 206 is memory 

controller/cache 208, which provides an interface to local 
memory 209. I/O bus bridge 210 is connected to system bus 
206 and provides an interface to I/O bus 212. Memory 
controller/cache 208 and I/O bus bridge 210 may be 

2 0 integrated as depicted. 

Peripheral component interconnect (PCI) bus bridge 
214 connected to I/O bus 212 provides an interface to PCI 
local bus 216. A number of modems may be connected to PCI 
local bus 216. Typical PCI bus implementations will 
25 support four PCI expansion slots or add-in connectors. 

Communication links to clients 108-112 in Figure 1 may be 
provided through modem 218 and network adapter 220 
connected to PCI local bus 216 through add-in boards. 

Additional PCI bus bridges 222 and 224 provide 

3 0 interfaces for additional PCI local buses 226 and 228, 

from which additional modems or network adapters may be 
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supported. In this manner, data processing system 200 
allows connections to multiple network computers. A 
memory-mapped graphics adapter 230 and hard disk 232 may 
also be connected to I/O bus 212 as depicted, either 
5 directly or indirectly. 

Those of ordinary skill in the art will appreciate 
that the hardware depicted in Figure 2 may vary. For 
example, other peripheral devices, such as optical disk 
drives and the like, also may be used in addition to or in 

10 place of the hardware depicted. The depicted example is 
not meant to imply architectural limitations with respect 
to the present invention. 

The data processing system depicted in Figure 2 may 
be, for example, an IBM eServer pSeries system, a product 

15 of International Business Machines Corporation in Armonk, 
New York, running the Advanced Interactive Executive 
(AIX) operating system or LINUX operating system. 

With reference now to Figure 3, a block diagram 
illustrating a data processing system is depicted in which 

2 0 the present invention may be implemented. Data processing 
system 3 00 is an example of a client computer. Data 
processing system 300 employs a peripheral component 
interconnect (PCI) local bus architecture. Although the 
depicted example employs a PCI bus, other bus 

25 architectures such as Accelerated Graphics Port (AGP) and 
Industry Standard Architecture (ISA) may be used. 
Processor 302 and main memory 304 are connected to PCI 
local bus 306 through PCI bridge 308. PCI bridge 308 also 
may include an integrated memory controller and cache 

30 memory for processor 302. Additional connections to PCI 
local bus 306 may be made through direct component 
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interconnection or through add- in boards. In the depicted 
example, local area network (LAN) adapter 310, SCSI host 
bus adapter 312, and expansion bus interface 314 are 
connected to PCI local bus 306 by direct component 
5 connection. In contrast, audio adapter 316, graphics 

adapter 318, and audio/video adapter 319 are connected to 
PCI local bus 306 by add- in boards inserted into expansion 
slots. Expansion bus interface 314 provides a connection 
for a keyboard and mouse adapter 320, modem 322, and 

10 additional memory 324. Small computer system interface 

(SCSI) host bus adapter 312 provides a connection for. hard 
disk drive 32 6, tape drive 328, and CD-ROM drive 33 0. 

An operating system runs on processor 302 and is used 
to coordinate and provide control of various components 

15 within data processing system 300 in Figure 3. The 

operating system may be a commercially available operating 
system, such as Windows XP, which is available from 
Microsoft Corporation. An object oriented programming 
system such as Java may run in conjunction with the 

2 0 operating system and provide calls to the operating system 

from Java programs or applications executing on data 
processing system 300. "Java" is a trademark of Sun 
Microsystems, Inc. Instructions for the operating system, 
the object-oriented operating system, and applications or 
25 programs are located on storage devices, such as hard disk 
drive 326, and may be loaded into main memory 304 for 
execution by processor 302 • 

Those of ordinary skill in the art will appreciate 
that the hardware in Figure 3 may vary depending on the 

3 0 implementation. Other internal hardware or peripheral 

devices, such as flash read-only memory (ROM) , equivalent 
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nonvolatile memory, or optical disk drives and the like, 
may be used in addition to or in place of the hardware 
depicted in Figure 3. Also, the processes of the present 
invention may be applied to a multiprocessor data 
5 processing system. 

The depicted example in Figure 3 and above-described 
examples are not meant to imply architectural 
limitations. For example, data processing system 300 
also may be a notebook computer or hand held computer in 

10 addition to taking the form of a PDA. Data processing 
system 300 also may be a kiosk or a Web appliance. 

The present invention provides a method, apparatus, 
and computer instructions for a configurable JavaServer 
pages (JSP) processing framework to process JSP. In a 

15 preferred embodiment, the processing framework of the 

present invention is configurable to invoke user-supplied 
classes that meet specific requirements of a JSP 
processor in a user-defined sequence, in order to gather 
information about a JSP document or page. The user- 

2 0 supplied classes are known as "visitor" classes. 

When a JSP processor, such as a service or tool 
provider, wants to gather information from a JSP document 
or page, the JSP processor provides "visitor" classes to 
perform custom functions to process the JSP document. 
25 The processing framework of the present inventions allows 
the JSP processor to define necessary "visitor" classes 
to be invoked and the order in which the "visitor" 
classes are invoked in an XML format file. This file 
also is known as JSP visitor configuration file. 

3 0 Prior to processing a JSP document or page, the 

processing framework translates a JSP document or page 
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using a document object model (DOM) generator into a DOM 
object and validates the syntax of the JSP document or 
page by invoking built-in classes of the processing 
framework. If any error occurs as a result of 
5 validation, the error is returned to the JSP processor. 
If no error occurs, the processing framework instantiates 
a set of "visitor" classes according to the order defined 
in the JSP visitor configuration file to process the DOM 
obj ect . 

10 The processing framework processes the DOM object by 

visiting each node or element of the object and invokes 
methods in the "visitor" classes to process each node or 
element. For example, when a JSP include action element 
is encountered, the "visit Jsplnclude" method in 

15 "JspAnalyzerVisitor" class is invoked to increment the 
count value of " JspIncludeCount" . The result of one 
"visitor" class's processing may be passed to the next 
"visitor" class in the processing sequence using a hash 
map, which is a complex data object that contains a set 

20 of keys and values. The use of a hash map allows one 
"visitor" class to store data specific to its needs or 
the needs of other "visitor" classes that are further 
down in the processing sequence. 

Turning next to Figure 4, a diagram illustrating 

25 processing framework in a data processing system is 

depicted in accordance with a preferred embodiment of the 
present invention. As depicted in Figure 4, the 
processing framework of the present invention may be 
implemented in different types of data processing 

30 systems, such as client 402 and application server 404. 
Client 402 may be implemented using a data processing 
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system, such as data processing system 300 in Figure 3. 
Application server 404 may be implemented using a data 
processing system, such as data processing system 200 in 
Figure 2 . 

5 A Web developer may run a JSP processor, such as 

integrated development environment (IDE) 408, on client 
402 to author or test JSP pages. A Web developer may 
also run another JSP processor, such as JSP engine 410, 
to generate a Java source file from the JSP page. 

10 Currently, JavaServer pages (JSP) are stored in a Web 

server 406. When a JSP processor, such as IDE 408 or JSP 
engine 410, requests a JSP page to be processed, Web 
server, such as Web server 406 responds by sending the 
desired JSP page to corresponding processing framework 

15 412 or 414. Then, processing framework 412 or 414 

translates the JSP page into a DOM object using a DOM 
generator and validates the syntax of the JSP page by 
invoking built-in classes, such as "ValidateJspVisitor" 
class. If the syntax is correct, processing framework 

20 412 invokes custom "visitor" classes to present a 
graphical view of the JSP page for editing, and 
processing framework 414 invokes custom "visitor" classes 
to generate Java source file from the JSP page. Thus, 
through the use of processing framework of the present 

25 invention, each JSP processor may perform common 

functions, such as validation of the JSP page, as well as 
custom functions, such as generating Java source file, by 
invoking custom "visitor" classes. 

The processing framework in the illustrative 

30 examples include five primary components: a document 
object model (DOM) generator, a JSP configuration 
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manager, a JSP translator factory, a JSP visitor 
configuration file, and a JSP translator. 

The DOM generator creates a DOM object from a JSP 
document or page. A JSP document is a JSP page or tag 
5 file written in XML syntax. A JSP page in the examples 
is a JSP page or tag file written in a classic syntax. 
Classic syntax is JSP syntax used primarily before 
version 1.2 of the JSP specification. In order to 
generate a DOM object from a JSP page or tag file in 

10 classic syntax, the DOM generator has detailed knowledge 
of classic JSP syntax. The resulting object generated by 
the DOM generator is used for syntax validation. 

Turning next to Figure 5, a diagram illustrating 
components of translating a JSP document or page into a 

15 DOM object using a DOM generator is depicted in 

accordance with a preferred embodiment of the present 
invention. As depicted in Figure 5, JSP document 502 or 
JSP page 504 is first located by JSP2Dom 506. JSP2Dom 
506 is a class that translates a JSP document or page 

2 0 into a DOM object. In order to perform translation, 

JSP2Dom 506 first parses JSP document 502 or JSP page 504 
by using JSPDocumentParser 508 or JSPPageParser 510, 
respectively. JSPDocumentParser 508 or JSPPageParser 510 
reads JSP document 502 or JSP page 504 and parses JSP 

2 5 document 502 or page 504 into parent nodes of DOM object 

516. 

If a static include statement, meaning other JSP 
files are needed, is found within JSP document 502 or JSP 
page 504, JSPDocumentParser 508 or JSPPageParser 510 

3 0 creates a new instance of JSP2Dom 512 and 514 for each 

included file. JSP2Dom instances 512 and 514 in turn 



15 EXPRESS MAIL NO. EV33342193XUS 

Docket NO.RSW920030178US1 

translate the included JSP file into a new DOM object and 
insert new DOM nodes into DOM object 516 as child nodes. 
The included JSP file may be in a different format than 
its parent JSP file. For example, JSP document 502 may 
5 include a JSP page and JSP page 504 may include a JSP 
document . 

The second primary component of the processing 
framework is the JSP configuration manager. The JSP 
configuration manager configures JSP via JSP property 

10 groups in web.xml file. A web.xml file is a XML file that 
defines settings of Web components, such as Java servlets 
and tag library descriptors (TLD) . A JSP property group 
is a group of JSP pages with certain properties, such as 
page encoding, and expression language evaluation. A 

15 given property group applies to JSP that matches a URL 

pattern that is defined in the group. When a Web module 
is loaded, JSP property groups are also loaded from the 
web.xml file. 

When a JSP processor such as JSP engine requests for 
20 a JSP page for translation, the JSP configuration manager 
matches the request URL to the pre-loaded property group 
and returns a JSPConf iguration object created from the 
property group (s) that apply to the specific JSP. The 
JSPConf iguration object is used during the translation 
2 5 phase of processing a JSP page to determine the kind of 
parsers and writer for parsing. 

The third primary component is the JSP translator 
factory. The JSP translator factory is the entry point 
into the processing framework of the present invention. 
30 When a JSP processor request a JSP page or document to be 
processed, the JSP translator factory enables the 
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processing framework to be configurable by using a 
configuration file called JSP visitor configuration file, 
which is the fourth primary component of the processing 
framework. The JSP visitor configurations file allows a 
5 collection of user-supplied "visitor" classes to be used 
for processing the JSP document or page in the processing 
sequence specified in the file. The JSP configuration 
file adheres to a schema. 

Turning next to Figure 6, a diagram of an example 

10 schema used in accordance with a preferred embodiment of 
the present invention for the JSP configuration file is 
depicted in accordance with the present invention. As 
depicted in Figure 6, JSP visitor configuration schema 
602 is an XML schema that includes two types of elements, 

15 j sp-visitor-def inition 604 and j sp-visitor-collection 
606. Jsp-visitor-def inition 604 element identifies 
visitor class name 608 and result class 610. Visitor 
class name 608 processes the DOM object, and result class 
610 returns the results of processing. Jsp-visitor- 

20 definition 604 element also identifies an id 612, which 
is the name of this definition, such as w JspValidate" . 

Jsp-visitor-collection 606 element identifies 
collection of one or more of the j sp-visitor-def initions 
604. Each definition of the collection includes an id, 

25 such as id 614; an order, such as order 616; and visits, 
such as visits 618. Id 614 is the name of the 
definition, such as w JspValidate'' . Order 616 is the 
order of execution for the visitor definition within this 
collection. Visits 618 is the number of times the 

30 visitor definition should be executed to visit the DOM 
object . 
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The order of execution is important because one 
visitor may depend on results of a previous visitor. The 
number of visits by a visitor within a collection also is 
important because a visitor may have discrete phases of 
5 operation that needs to be called separately. For 

example, a Java code generation visitor has to generate 
seven discrete sections of a Java source file. Each 
section involves participation of different methods 
within the class that must be executed in a particular 

10 order. In addition, j sp-visitor-collection 606 element 
includes an id, such as id 620. This id is the name of a 
collection, such as " JspTranslation" . 

Turning now to Figure 7, a diagram illustrating an 
example JSP visitor configuration file is depicted in 

15 accordance with a preferred embodiment of the present 
invention. As depicted in Figure 7, JSP visitor 
configuration file 702 is a XML file that defines a set 
of visitor classes. JSP visitor configuration file 702 
is a default configuration file of the processing 

2 0 framework in the illustrative examples, but a user may 
customize it to include user-supplied "visitor" classes. 
A number of j sp-visitor-def initions or "visitor" classes, 
such as JspValidate 704, JspGenerate 706, 
TagFileDependencyCheck 708, TagFileScan 710, 

25 TagFileValidate 712, TagFileGenerate 714, and Smap 716 
are defined in this example. Within each definition, a 
class name and a result class is defined. For example, 
JspValidate includes a class name 

"com. ibm. ws . j sp. translator .visitor .validator . ValidateJspV 
30 isitor" 718 and a result class 
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"com . ibm . ws . j sp . translator . vi s i tor . val idator . Val idate JspR 
esult" 720. 

In addition, JSP visitor configuration file 702 
includes a number of j sp-visitor-collections , such as, 
5 for example, JspTranslation 722, DebugJspTranslation 724, 
TagFileTranslation 726, DebugTagFileTranslation 728, and 
TagFileDependency 730. Within each collection, a number 
of definitions are defined with corresponding execution 
order and number of visits. For example, JspTranslation 

10 722 includes TagFileDependencyCheck 732 to be executed 
first, followed by JspValidate 734 and JspGenerate 736, 
which is executed seven times in order to generate a Java 
source file. Thus, JSP visitor configuration file 
enables processing of the JSP document or page to be 

15 configurable, so that custom functions may be performed 
by the JSP processor to satisfy different requirements. 

Once the JSP translator factory is initialized with 
a custom collection of "visitor" classes from the JSP 
visitor configuration file, the JSP translator factory 

2 0 creates an instance of the JSP translator with the name 
of the collection, the path of the JSP page or document, 
and a reference to the JSP configuration object returned 
from the JSP configuration manager. The JSP translator 
is the fifth primary component of the processing 

25 framework in the illustrative examples. 

The JSP translator created by the factory processes 
the JSP document or page by first calling Jsp2Dom, as 
described above, to translate a JSP page or document into 
a DOM object. The JSP translator then invokes its 

30 processVisitors method to allow "visitor" classes in the 
collection to "visit" the DOM object as many times as and 



19 EXPRESS MAIL NO. EV333421931US 

Docket NO.RSW920030178US1 

in the order specified in the JSP visitor configuration 
file, in order to operate on the DOM object. 

Turning next to Figure 8, a diagram illustrating 
components used in processing DOM object using a 
5 collection of visitor classes is depicted in accordance 
with a preferred embodiment of the present invention. As 
depicted in Figure 8, in this example implementation, a 
collection includes four "visitor" classes in execution 
order: JSP visitor class 1 802, JSP visitor class 2 804, 

10 JSP visitor class 3 806, and JSP visitor class 4 808. 
Once a JSP translator, such as JSP translator 810, is 
created by the factory, JSP translator 810 calls JSP2Dom 
to parse a JSP document into DOM object 812. 

JSP translator 810 invokes its processVisitors 

15 method, which calls JSP visitor class 1 802 as many times 
as defined in the JSP visitor configuration file to 
operate on the DOM object 812. For example, JSP visitor 
class 1 802 may be a w JspValidate" class executed one 
time to validate the syntax of the JSP. 

20 The results of processing performed by JSP visitor 

class 1 802, represented by visitor result class 1 814, 
is returned to JSP translator 810. The name of visitor 
result class 1 814 is also defined in the JSP visitor 
configuration file. Results of each visit are stored in 

25 a hash map. A hash map is a complex data object that 

contains a set of keys and values. The hash map allows 
each visitor to store result data specific to its needs, 
or needs of other visitor classes further down the 
processing sequence . 

30 For example, a visitor may store in the HashMap all 

the properties of a tag file that were discovered during 
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validation. In this example, the hash map of visitor 
result class 1 814 may be passed to JSP visitor class 2 
804, the hash map of visitor result class 2 816 may be 
passed to JSP visitor class 3 806, and the hash map of 
5 visitor result class 1 818 may be passed to JSP visitor 
class 2 808, etc. In the illustrative examples, the hash 
map is also called a resultMap, which is used to build up 
a set of visitor results that is added to when a visitor 
completes processing. When the resultMap is passed to 
'10 s the next visitor class in the processing sequence, the 
data structure contains results of all previous visitor 
classes . 

Turning next to Figure 9, a flowchart process of 
configurable JSP processing framework of the present 

15 invention is depicted in accordance with a preferred 
embodiment of the present invention. As depicted in 
Figure 9, from the processing framework's perspective, 
the process begins when a JSP processor, such as a JSP 
engine or an integrated development requirement (IDE) , 

2 0 requests a JSP page or document to be processed (step 

902). Next, the processing framework initializes the JSP 
translator factory according to "visitor" classes defined 
in the JSP visitor configuration file (step 904) . The 
JSP translator factory then creates a JSP translator 

25 instance (step 906) . 

The JSP translator then translates the JSP page or 
document into a DOM object by calling JSP2Dom (step 908) . 
Once the DOM object is created, the JSP translator 
invokes its processVisitors method to invoke a visitor 

30 class (step 910) . The visit method of the visitor class 
is then invoked to visit the DOM object to gather 
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information about a JSP (step 912). Visit results are 
returned to the JSP translator once information is 
gathered (step 914) . 

Thereafter, determination is made by the JSP 
5 translator as to whether additional visits by the visitor 
class is required (step 916) . If additional visits by 
the visitor class is required, the JSP translator returns 
to step 912 and invokes the visit method of the current 
visitor class again to visit the DOM object. 

10 If additional visits by the visitor class is not 

required, a determination is made by the JSP translator 
as to whether more visitor classes are defined in the JSP 
visitor configuration file (step 918) . If additional 
visitor classes are defined in the JSP visitor 

15 configuration file, the JSP translator then locates the 
visitor class in the next execution order according to 
the JSP visitor configuration file (step 920) and returns 
to step 912 to invoke the visit method of the next 
visitor class to visit the DOM object. If additional 

20 visitor classes are not defined in the JSP visitor 

configuration file, the process terminates thereafter. 

Using the processing framework of the present 
invention, a service or tool provider would be relieved 
of the need to convert a JSP page or document into a DOM 

25 object, and to validate that the JSP page or document is 
syntactically correct, both of which requires additional 
development effort and knowledge of the JSP 
specification. For example, in order to perform 
validation of syntax, the value of each element of the 

3 0 JSP document or page including its tag files are 

validated against the syntax of the JSP specification. 
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Turning next to Figure 10A, a diagram illustrating 
example validation of JSP is depicted in accordance with 
a preferred embodiment of the present invention. As 
depicted in Figure 10A, ValidateJSPVisitor program 1002 
5 includes a method visit JspOutputStart 1004. 

VisitJspOutputStart 1004 takes a JSP element 1006 as an 
input parameter. 

Next, attributes of the JSP element 1006 are 
validated against the syntax of the specification using 

10 method validateAttributes 1008 , which takes a list ,of 
output attribute names from the specification, 
outputAttrNames 1010, and validates against attributes of 
JSP element 1006. 

After the value of attributes from JSP element 1006 

15 are validated, value of the attribute nodes, such as 
docTypeRootElement 1012, docTypeSystem 1014 and 
docTypePublic 1016 are checked to make sure that they are 
not null, in order to comply with the JSP specification. 
Turning next to Figure 10B, a diagram illustrating 

20 example validation of a tag file is depicted in 

accordance with a preferred embodiment of the present 
invention. As depicted in Figure 10B, 
ValidateTagFileVisitor program 102 0 includes a method 
visit JspDoBodyStart 1022, which takes a JSP element 1024 

25 as an input parameter. First, a list of attributes from 
the JSP element of a tag file is gathered as 
specif iedStandardActionAttrs 1026 . 

Then, specif iedStandardActionAttrs 1026 are 
validated against doBodyAttrNames 102 8, which is a list 

3 0 of attribute names from the specification, using method 
validateAttributes 1030. Further in program 
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ValidateTagFileVisitor 1020, the scope 1032 of the tag 
file is validated by checking its value to determine 
whether it is equal to one of u page" 1034, "request" 
1036, "session" 1038 or "application" 1040. These are 
5 all valid scope defined in the specification. 

In addition to syntax validation, common typical 
operations, such as collection of included tag files, 
generation of Java source file for a JSP page or document 
and its tag files, are supported by the processing 

10 framework of the present invention. 

Turning next to Figure 11, a diagram illustrating 
component interactions for validating a JSP and 
generating Java source file from the JSP is depicted in 
accordance with a preferred embodiment of the present 

15 invention. As depicted in Figure 11, JSPTranslatorUtil 
1102 is a class, which initiates the processing of a JSP 
document or page. JSPTranslatorUtil 1102 initializes the 
JSPTranslatorFactory 1104 by invoking the initialize 
method (call 1120) with the path of the JSP visitor 

20 configuration file, which defines a collection of 
"visitor" classes . 

Once JSPTranslatorFactory 1104 is initialized, the 
JSPTranslatorUtil 1102 creates an instance of 
JSPTranslator 1106 by invoking createTranslator method 

25 (call 1122) of JSPTranslatorFactory 1104. Next, 

JSPTranslatorUtil 1102 invokes the processVisitors method 
(call 1124) of JSPTranslator 1106 in order to execute the 
visitor classes. JSPTranslator 1106 invokes the visit 
method (call 1126) of the visitor class, such as 

30 ValidateJSPVisitor 1108, to validate the JSP. 

ValidateJSPVisitor 1108 in turns invokes method 
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processJSPElement (call 1128) to process JSP elements. 
If child node exists, processChildren (call 1130) calls 
processJSPElement 1128 recursively until all child nodes 
are validated. 
5 Once all the elements and nodes are validated, 

JSPTranslator 1106 invokes the visit method (call 1132) 
of the next visitor class according to the JSP visitor 
configuration file, GenerateJSPVisitor 1110. In the 
illustrative examples, GenerateJSPVisitor 1110 includes 

10 methods that generate seven sections of a Java source 
file for a JSP document or page. The seven sections 
include import, class, static initializer, init, method 
init, method, and finally. In this example, two of the 
seven sections are generated by invoking 

15 generatelmportSection (call 1134) and generatelnitSection 
(call 1136) methods of generateJSPVisitor 1110. 

A JSP document or page may include tag files, which 
are custom tag files used by the JSP. Since one tag file 
may include another tag file, the processing framework of 

2 0 the present invention checks and collect the dependencies 
of tag files for a given JSP. Turning back to Figure 11, 
JSPTranslator 1106 invokes the visit method 113 8 of 
TagFileDependencyVisitor 1112 in order to check for 
dependencies. TagFileDependencyVisitor 1112 executes its 

25 visitCustomTagStart method (call 1138) recursively to 
determine if a tag file is found in the JSP. If a tag 
file is found, a new JSPTranslator, JSPTranslator2 1114 
is created to process the tag file. The cycle continues 
as long as one tag file depends on another by invoking 

30 processVisitors method (call 1140) of JSPTranslator2 
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1114. Consequently, all dependencies are collected into 
a dependency list at the top-level JSPTranslator . 

After all dependent tag files are collected, the 
child nodes of the node that started off this sequence 
5 are now processed by invoking the processChildren method 
(call 1142) . To complete processing of the JSP, tag 
files collected are validated by invoking visit method 
(call 1144) of validateTagFileVisitor 1116. 
ValidateTagFileVisitor 1116 invokes 

10 visitTagDirectiveStart method (call 1146) to validate the 
tag file. Finally, a Java source file for the tag file 
is generated by invoking visit method (call 1148) of 
generateTagFileVisitor 1118, which in turn invokes its 
generatelmportSection method (call 1050) , 

15 generateClassSection method (call 1152) , and 

generatelnitSection method (call 1154) . These three 
methods generate three of the seven sections in a Java 
source file. 

Thus, the present invention provides a configurable 
20 JSP processing framework to process JSP document or page. 
By allowing the processing framework to be configured 
through the use of a XML JSP visitor configuration file, 
custom functions may be performed selectively to gather 
information about a JSP. Consequently, new and different 
25 requirements of JSP processors are satisfied. In 

addition, by translating a JSP into a DOM object, common 
requirements that involve knowledge of the specification, 
such as validation of syntax, may be performed. Hence, 
the present invention easily adapts to new requirements 
30 of JSP processors and evolving specification. 
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It is important to note that while the present 
invention has been described in the context of a fully 
functioning data processing system, those of ordinary 
skill in the art will appreciate that the processes of 
5 the present invention are capable of being distributed in 
the form of a computer readable medium of instructions 
and a variety of forms and that the present invention 
applies equally regardless of the particular type of 
signal bearing media actually used to carry out the 

10 distribution. Examples of computer readable media 

include recordable -type media, such as a floppy disk, a 
hard disk drive, a RAM, CD-ROMs, DVD-ROMs, and 
transmission- type media, such as digital and analog 
communications links, wired or wireless communications 

15 links using transmission forms, such as, for example, 
radio frequency and light wave transmissions. The 
computer readable media may take the form of coded 
formats that are decoded for actual use in a particular 
data processing system. 

2 0 The description of the present invention has been 

presented for purposes of illustration and description, 
and is not intended to be exhaustive or limited to the 
invention in the form disclosed. Many modifications and 
variations will be apparent to those of ordinary skill in 

2 5 the art. The embodiment was chosen and described in 
order to best explain the principles of the invention, 
the practical application, and to enable others of 
ordinary skill in the art to understand the invention for 
various embodiments with various modifications as are 

30 suited to the particular use contemplated. 



